home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / Slackwar / docs / Intranet-Server-HOWTO < prev    next >
Text File  |  1997-08-07  |  39KB  |  996 lines
  1.   The Linux Intranet Server HOWTO
  2.   Pramod Karnad, karnad@indiamail.com
  3.   v2.11, 7 August 1997
  4.  
  5.   This document describes how to setup an Intranet using Linux as the
  6.   server which binds Unix, Netware, NT and Windows together. Hence by
  7.   just establishing the connection to the Linux box you are provided
  8.   transparent access to all the various platforms. Detailed explanations
  9.   are provided for setting up HTTP using the NCSA server and connect to
  10.   it using TCP/IP clients from Novell, Microsoft under Windows3.1,
  11.   WFWG,Win95 and WinNT and MacTCP on the Apple PowerMac.
  12.  
  13.   1.  Introduction
  14.  
  15.   In simple terms, the Intranet is the descriptive term being used for
  16.   the implementation of Internet technologies within a corporate
  17.   organisation, rather than for external connection to the global
  18.   Internet. This implementation is performed in such a way as to
  19.   transparently deliver the immense informational resources of an
  20.   organisation to each individuals desktop with minimal cost, time and
  21.   effort. This document attempts to explain in simple terms how to setup
  22.   an Intranet using tools which are readily available and are generally
  23.   costing little or are free.
  24.  
  25.   This document assumes that you already know how to install TCP/IP on
  26.   your Linux server and connect it physically to your LAN using an
  27.   Ethernet network card. This also assumes you have some basic knowledge
  28.   of Netware, WinNT and Mac systems. The configuration of the Netware
  29.   server has been shown using version 3.1x as the basis. You can also
  30.   use INETCFG to achieve the same result. On the client side the
  31.   discussion is with respect to Windows 3.1x, Windows for Workgroups and
  32.   Win95, WinNT and the Apple PowerMac.
  33.  
  34.   I am using the private network addresses (RFC-1918) of 172.16.0.0 and
  35.   172.17.0.0 only as examples. You may choose suitable addresses
  36.   depending on your configuration.
  37.  
  38.               Linux       Netware      WFWG/WinNT
  39.               Server      Server       Server
  40.              172.16.0.1   172.16.0.2   172.16.0.3
  41.                 |           |           |    172.16.0.0
  42.           ------+-----+-----+--------+--+--------------
  43.                       |              | 172.16.0.254
  44.                     W/S 1          Router
  45.                   172.16.0.5         | 172.17.0.254
  46.                                      |
  47.                            ----------+-------+--------
  48.                       172.17.0.0             |
  49.                                            W/S 2
  50.                                          172.17.0.5
  51.  
  52.   1.1.  What is required
  53.  
  54.   You will need the following software before attempting the
  55.   installation.
  56.  
  57.   ╖  the HTTP server software which can be downloaded from OneStep NCSA
  58.      HTTPd Downloader at
  59.      http://hoohoo.ncsa.uiuc.edu/docs/setup/OneStep.html page.
  60.  
  61.   ╖  The Novell Netware Client available from HTTP://support.novell.com/
  62.      (The TCP/IP files are included with the client).
  63.  
  64.   ╖  The Microsoft TCP/IP client available from
  65.      HTTP://www.microsoft.com/
  66.  
  67.   ╖  The Apple MacTCP client available from HTTP://www.apple.com/
  68.  
  69.   ╖  WWW Browsers like Netscape at HTTP://home.netscape.com/ or MS
  70.      Internet Explorer at HTTP://www.microsoft.com/ or NCSA Mosaic from
  71.      http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/NCSAMosaicHome.html
  72.  
  73.   1.2.  New versions of this document
  74.  
  75.   New versions of the Linux Intranet Server HOWTO will be periodically
  76.   posted to comp.os.linux.announce and comp.os.linux.help. They will
  77.   also be uploaded to various Linux FTP sites, including
  78.   sunsite.unc.edu.
  79.  
  80.   The Latest version of this document is available in HTML format at
  81.   http://www.inet.co.th/cyberclub/karnadp/http.html
  82.  
  83.   1.3.  Feedback
  84.  
  85.   If you have questions or comments about this document, please feel
  86.   free to mail Pramod Karnad, at karnad@indiamail.com. Suggestions,
  87.   criticism and mail are always welcome. If you find a mistake with this
  88.   document, please let me know so I can correct it in the next version.
  89.   Thanx.
  90.  
  91.   2.  Install the HTTP server
  92.  
  93.   When you download the server you have two options: To get the source
  94.   and compile it yourself, or get the precompiled binaries. The
  95.   precompiled binaries for Linux (ELF) version are available at NCSA but
  96.   not the older versions.
  97.  
  98.   2.1.  Preparation before downloading
  99.  
  100.   The server at NCSA will guide you through the steps for configuration
  101.   options and prepare the various files for you. But before you attempt
  102.   to download HTTPd be prepared with answers to the following questions
  103.  
  104.   2.1.1.  The Operating System
  105.  
  106.   First, you must choose whether to download the source or a pre-
  107.   compiled version of the software. If your particular system doesn't
  108.   appear in the menu, then you will have to get the default source, and
  109.   compile it yourself.
  110.  
  111.   To check the version of your Linux go to the command prompt on your
  112.   Linux machine and type
  113.  
  114.          linux:~$  uname -a
  115.  
  116.   which will respond with a line which looks similar to this
  117.  
  118.      linux:~$  uname -a
  119.      Linux linux 2.0.29 #4 Tue Sep 13 04:05:51 CDT 1994 i586
  120.      linux:~$
  121.  
  122.   The version of Linux is 2.0.29.
  123.  
  124.   The remaining parameters can be specified before downloading or
  125.   configured later by modifying the file srm.conf in the
  126.   /usr/local/etc/httpd/conf directory. The names of the actual
  127.   directives that appear in the file httpd.conf are shown in brackets.
  128.   The only exception is the directive DocumentRoot which appears in the
  129.   file srm.conf
  130.  
  131.   2.1.2.  Process type (ServerType)
  132.  
  133.   This specifies how your machine will run your HTTPd server. The
  134.   preferred method is 'standalone'. This makes the HTTP daemon to be
  135.   running constantly. If you choose to load HTTPd under 'inetd', the
  136.   server binary will be reloaded into memory for every request, which
  137.   may slow your server down.
  138.  
  139.   2.1.3.  Binding Port (Port)
  140.  
  141.   This specifies which port of your machine that the HTTPd daemon will
  142.   bind to and listen for HTTP requests. If you can login as 'root', use
  143.   the default setting of 80.  Otherwise choose a setting between 1025
  144.   and 65535.
  145.  
  146.   2.1.4.  Server user identity (User)
  147.  
  148.   This is the user id the server will change to when answering requests
  149.   and acting on files.This question needs to be answered only if you are
  150.   running the server as 'standalone'.  If you are someone without root
  151.   permissions, just use your own login name. If you are system
  152.   administrator, you might want to create a special user so you can
  153.   control file permissions.
  154.  
  155.   2.1.5.  Server group identity (Group)
  156.  
  157.   This is the group id the server will change to when answering requests
  158.   and acting on files. This is similar to Server User identity and is
  159.   applicable only if you are running the server as standalone.
  160.  
  161.   If you do not have root permissions, just use the name of your primary
  162.   group. You can find out your group by typing groups at the Linux
  163.   command prompt.
  164.  
  165.   2.1.6.  Server administrator email address (ServerAdmin)
  166.  
  167.   This is the email address that the user should send an email message
  168.   to when reporting a problem with the server. You can put your personal
  169.   e-mail address.
  170.  
  171.   2.1.7.  Location of server directory (ServerRoot)
  172.  
  173.   This is where the server resides on your system. If you have root
  174.   permissions leave it in its recommended location /usr/local/etc/httpd.
  175.   If you cannot login as root, choose a subdirectory in your home path.
  176.   You can find out the path of your home directory with the pwd command.
  177.  
  178.   2.1.8.  Location of HTML files (DocumentRoot)
  179.  
  180.   This is where the HTML files to be served are located. The default
  181.   location is /usr/local/etc/httpd/htdocs.  You could however set it to
  182.   be the home directory of the special user you chose in Server user
  183.   identity, or a subdirectory in your home directory if you can't login
  184.   as root.
  185.  
  186.   When in doubt, use the default settings. Now that you have answers to
  187.   the above questions you can Download NCSA HTTPd at
  188.   http://hoohoo.ncsa.uiuc.edu/docs/setup/OneStep.html.  You should read
  189.   the HTTPd Documentation at http://hoohoo.ncsa.uiuc.edu/docs/ before
  190.   you attempt installation. If you are planning to compile the code then
  191.   you need to modify the makefiles in each of the th ree directories
  192.   support, src, cgi-src. If your version of Linux is already supported
  193.   then you just have to type make linux at the top level directory (i.e.
  194.   /usr/local/etc/httpd)
  195.  
  196.   2.2.  Compiling HTTPd
  197.  
  198.   Compiling is simple, just type make linux at the prompt in the server
  199.   root directory.  Note: Users of pre-ELF Linux have to uncomment
  200.   #define NO_PASS in file portability.h and set DBM_LIBS= -ldbm in the
  201.   Makefile before compiling HTTPd.
  202.  
  203.   3.  Testing HTTPd
  204.  
  205.   After you have installed HTTPd, login as root and start it by typing
  206.   httpd & . (assuming you have installed as standalone) You should now
  207.   be able to see it in the list generated by ps. The simplest way to
  208.   test HTTPd is by Telnet. At the Linux command prompt type
  209.  
  210.           linux:~$  telnet 172.16.0.1 80
  211.  
  212.   where 80 is the default port for HTTP. If you have configured 'Port'
  213.   as something different then type that number instead. You should get a
  214.   response which looks like this
  215.  
  216.           Trying 172.16.0.1...
  217.           Connected to linux.mydomain.
  218.           Escape character is '^]'.
  219.  
  220.   Now if you type in any character and press Enter you should get a
  221.   response similar to the one shown below.
  222.  
  223.      HTTP/1.0 400 Bad Request
  224.      Date: Wed, 10 Jan 1996 10:24:37 GMT
  225.      Server: NCSA/1.5
  226.      Content-type: text/html
  227.  
  228.      <HEAD><TITLE>400 Bad Request < /TITLE> < /HEAD>
  229.      <BODY><H1>400 Bad Request < /H1>
  230.      Your client sent a query that this server could
  231.      not understand.<P>
  232.      Reason: Invalid or unsupported method.<P>
  233.      < /BODY>
  234.  
  235.   Now we are ready to connect to this server using another PC and a WWW
  236.   Browser.
  237.  
  238.   4.  Connecting to the Linux Server
  239.  
  240.   Please refer to the diagram shown in the chapter ``Introduction'' for
  241.   the addressing scheme used. Workstation 1 (W/S1) is on network
  242.   172.16.0.0 and can access the Linux server directly whereas
  243.   Workstation 2 (W/S2) is on network 172.17.0.0 and needs to use the
  244.   gateway (router) 172.17.0.254 to access the Linux box. This gateway
  245.   information needs to be provided while configuring the clients only on
  246.   W/S2. Netware refers to the gateway as 'ip_router'.
  247.  
  248.   I am using W/S2 to illustrate the client setup. To setup W/S1 just
  249.   change the address 172.17.0.5 to 172.16.0.5 and ignore all references
  250.   to the gateway/router.
  251.  
  252.   If you do not have a router you can skip the next section and proceed
  253.   to
  254.  
  255.   ╖  ``Setup Netware Server'' if you use a Netware server.
  256.  
  257.   ╖  ``Setup MS Windows Client'' if you use the Microsoft Client.
  258.  
  259.   4.1.  Setup the Linux server
  260.  
  261.   You may skip this section if you do not have a router.
  262.  
  263.   You have to configure the Linux server to recognise the router thus
  264.   allowing Workstation 2 to connect to the Web server. In order to setup
  265.   the Linux server you should login as root. At the server prompt type
  266.  
  267.           route add gw default 172.16.0.254
  268.  
  269.   To use this gateway everytime you boot the Linux server edit the file
  270.   /etc/rc.d/rc.inet1 and change the line containing the gateway defini¡
  271.   tion to GATEWAY = "172.16.0.254". Make sure the line for adding the
  272.   gateway is not commented out.
  273.  
  274.   ALT: You can add routes to the networks on the other side of the
  275.   router. This would be done as
  276.  
  277.           route add -net 172.17.0.0 gw 172.16.0.254
  278.  
  279.   To add this route everytime you boot Linux add the command to your
  280.   /etc/rc.d/rc.local file.
  281.  
  282.   4.2.  Setup the Netware server
  283.  
  284.   In order to setup the Netware server you should have Supervisor
  285.   permissions or atleast Console operator permissions. If these cannot
  286.   be got, try asking your Network Administrator to help you with the
  287.   setup.  At the Server enable the Ethernet_II frame type on the LAN by
  288.   typing these commands or include them in the AUTOEXEC.ncf file.
  289.  
  290.           load NE2000 frame=Ethernet_II name=IPNET
  291.           load TCPIP
  292.           bind IP to IPNET addr=172.16.0.2 mask=FF.FF.FF.0
  293.  
  294.   You might have to specify the slot or board number while loading the
  295.   NE2000 driver depending on your machine configuration. (eg: load
  296.   NE2000 slot=3 frame=.....)
  297.  
  298.   4.3.  Setup the Netware Client
  299.  
  300.   On the PC you have the choice of Win3.1,WFWG or Win95. The
  301.   installation procedure differs between Win95 and the older windows if
  302.   you are using the 32bit client from Microsoft or Novell. If you are
  303.   going to use the 16bit client, the procedure is the same and you can
  304.   refer to the Windows 3.x installation instructions. For installing the
  305.   32bit client for Win95 skip to ``Windows 95 installation''.
  306.  
  307.   4.3.1.  Windows 3.x
  308.  
  309.   If you are using Win3.1 or WFWG you can install the Netware Client
  310.   (VLMs) and some additional files which are provided with the TCP/IP
  311.   diskette, namely
  312.  
  313.   TCPIP.exe, VTCPIP.386, WINSOCK.dll and WLIBSOCK.dll
  314.  
  315.   Note that the WINSOCK.dll file is different from the ones provided
  316.   with Win95 and Trumpet. Install the Netware Client with the support
  317.   for windows. Copy VTCPIP.386, WINSOCK.dll and WLIBSOCK.dll to the
  318.   SYSTEM directory and TCPIP.exe to the NWCLIENT directory. Now modify
  319.   the STARTNET.bat in the NWCLIENT directory to
  320.  
  321.           lsl
  322.           ne2000     ---> your network card driver
  323.           c:\windows\odihlp.exe     ---->if you are using WFWG
  324.           ipxodi
  325.           tcpip        ---> add this line
  326.           nwip         ---> if you use Netware/IP
  327.           vlm
  328.  
  329.   Create a subdirectory (say) \NET\TCP and copy the files HOSTS,
  330.   NETWORKS, PROTOCOLS and SERVICES from /etc on your Linux server or the
  331.   directory SYS:ETC on your Netware server. Edit the copied HOSTS file
  332.   to add the line for your new Linux server. This will enable you to
  333.   refer to the Linux server as http://linux.mydomain/ instead of
  334.   http://172.16.0.1/in your WWW browser
  335.  
  336.           127.0.0.1      localhost
  337.           172.16.0.1      linux.mydomain
  338.  
  339.   Edit the NET.cfg file in NWCLIENT directory
  340.  
  341.           Link Driver NE2000
  342.               port 300
  343.               int 3
  344.               MEM D0000
  345.               FRAME Ethernet_802.2
  346.  
  347.        ; ---- add these lines ----
  348.  
  349.              FRAME Ethernet_II
  350.  
  351.           Protocol TCPIP
  352.              PATH TCP_CFG C:\NET\TCP
  353.              ip_address  172.17.0.5
  354.              ip_netmask  255.255.255.0
  355.              ip_router   172.17.0.254     ---> add the address of your gateway only
  356.                                          ---> if you have to use this
  357.                                          ---> gateway to reach your HTTP server
  358.  
  359.           Link Support
  360.              MemPool 6192       ---> the minimum is 1024. Try with different values
  361.              Buffers 10 1580    ---> this again can be fine tuned
  362.  
  363.        ;---------------------------------
  364.        ; You may need to add lines like these if you are using Netware/IP
  365.        ;
  366.           NWIP
  367.              NWIP_DOMAIN_NAME  mydomain
  368.              NSQ_BROADCAST   ON
  369.              NWIP1_1 COMPATIBILITY   OFF
  370.              AUTORETRIES     1
  371.              AUTORETRY SECS  10
  372.  
  373.   Edit the SYSTEM.ini file in the WINDOWS directory and add this entry
  374.   for VTCPIP.386
  375.  
  376.           [386Enh]
  377.           .....
  378.           network=*vnetbios, vipx.386, vnetware.386, VTCPIP.386
  379.           .....
  380.  
  381.   Reboot your PC, run STARTNET.bat and you can now use your favorite WWW
  382.   browser to access your Web pages. You need not login to Netware and
  383.   you don't have to run TCPMAN (if you use Trumpet Winsock).
  384.  
  385.   4.3.2.  Windows 95
  386.  
  387.   This section explains how to install the 32bit client on Win95.
  388.   Firstly you must install the following
  389.  
  390.           Client for Netware Networks (from Microsoft or Novell)
  391.           Microsoft TCP/IP Protocol
  392.           Network Adapter
  393.  
  394.   To install these items, click on My Computer, Control Panel, Networks.
  395.   Click Add. You will now be in a window that displays Client, Adapter,
  396.   Protocol and Service.  To install the Client for Netware Networks:
  397.  
  398.          1. DoubleClick on Client
  399.          2. Click on Microsoft or Novell
  400.          3. DoubleClick on Client for Netware Networks
  401.  
  402.   To install the TCP/IP Protocol:
  403.  
  404.          1. DoubleClick on Protocol
  405.          2. Click on Microsoft
  406.          3. DoubleClick on TCP/IP
  407.  
  408.   Windows 95 by default installs several other protocols automatically.
  409.   Remove them by clicking on them and clicking the Remove button.
  410.   Typically Win95 installs the Microsoft NetBeui protocol, and IPX/SPX
  411.   compatible protocol. You can delete the NetBEUI protocol, but you will
  412.   need the IPX/SPX protocol if you wish to login to the Netware Server.
  413.  
  414.   To setup TCP/IP click on TCP/IP, click on Properties, click on the tab
  415.   IP address
  416.  
  417.          Enter your IP address in the 'Specify an IP address '
  418.                                box as 172.17.0.5
  419.          In the Subnet Mask box enter 255.255.255.0
  420.  
  421.   select the tab Gateway
  422.  
  423.          Enter your gateway (router) address in the box New gateway
  424.             as 172.17.0.254
  425.          Click the Add button
  426.  
  427.   The gateway address should now appear under the installed gateways
  428.   box. Now Click OK.
  429.  
  430.   You should get a message to reboot. Do so. You should now be able to
  431.   use the Browser to connect to your HTTP Server.
  432.  
  433.   4.4.  Setup Microsoft Client
  434.  
  435.   If you are using the Microsoft Client for accessing your network, then
  436.   this section details how to install TCP/IP for
  437.  
  438.   ╖  ``Windows for Workgroups (WFWG)''
  439.  
  440.   ╖  ``Windows 95''
  441.  
  442.   ╖  ``Windows NT 4.0''
  443.  
  444.      Note: To enable you to refer to the Linux server as
  445.      http://linux.mydomain/ instead of http://172.16.0.1/ in the WWW
  446.      browser and all your intranet commands you need to edit the hosts
  447.      file. You can add more entries for each of your other hosts
  448.      (Netware, Unix, WinNT) as well. The Windows family keeps its HOSTS
  449.      file in \WINDOWS or in \WINDOWS\SYSTEM depending on the version.
  450.      Edit this file and add a line for your Linux server as:
  451.  
  452.           127.0.0.1      localhost
  453.           172.16.0.1     linux.mydomain
  454.  
  455.           172.16.0.2     netware.mydomain
  456.           172.16.0.3     winNT.mydomain
  457.           172.16.0.5     ws_1
  458.  
  459.   4.4.1.  Windows for Workgroups
  460.  
  461.   This section explains how to install the 32bit client on WFWG. Firstly
  462.   you must download the TCP/IP drivers for Windows from Microsoft. The
  463.   current version is 3.11b and is available at ftp://ftp.microsoft.com
  464.   or other sites as tcp32b.exe. Make sure that you have load Win32s
  465.   before trying to load the TCP/IP-32bit driver.
  466.  
  467.   Having expanded the TCP/IP files into a temporary directory (say
  468.   C:\TEMP), check your \WINDOWS\SYSTEM directory for copies of
  469.   OEMSETUP.INF. If there are any, rename them. Now copy the OEMSETUP.INF
  470.   file from the TEMP directory to the \WINDOWS\SYSTEM directory. If you
  471.   have loaded any other TCP/IP stacks on your system, please remove them
  472.   before you proceed.
  473.  
  474.   Start Network Setup or Windows Setup/Change Network settings
  475.  
  476.            Click the Networks button
  477.            Click Install Microsoft Windows Network.
  478.              Choose support for additional networks (if required)
  479.            Click OK
  480.  
  481.   You should be prompted for your network adapter - select the appropri¡
  482.   ate one. If you are not prompted, then
  483.  
  484.        Click the Adapter button
  485.            select an adapter (say NE2000)
  486.            Click OK
  487.        Click the Protocol button
  488.            select the MS TCP/IP-32 protocol
  489.            click OK
  490.  
  491.   You will now be prompted to configure the TCP/IP protocol stack. You
  492.   can always reconfigure this by highlighting the TCP/IP protocol shown
  493.   in the box Adapters and clicking the Setup button.
  494.  
  495.           In the IP address box enter 172.17.0.5
  496.           In the Subnet Mask box enter 255.255.255.0
  497.           Enter your gateway (router) address in the box default gateway
  498.             as 172.17.0.254
  499.  
  500.   Click OK. The computer will ask you to restart. Do so. You should now
  501.   be able to use the Browser to connect to your HTTP Server.
  502.  
  503.   4.4.2.  Windows 95
  504.  
  505.   This section explains how to install the 32bit client for Microsoft on
  506.   Win95. Firstly you must install the following
  507.  
  508.           Client for Microsoft Networks
  509.           Microsoft TCP/IP Protocol
  510.           Network Adapter
  511.  
  512.   To install these items, click on My Computer, Control Panel, Networks.
  513.   Click Add. You will now be in a window that displays Client, Adapter,
  514.   Protocol and Service.  To install the Client for Microsoft Networks:
  515.  
  516.          1. DoubleClick on Client
  517.          2. Click on Microsoft
  518.          3. DoubleClick on Client for Microsoft Networks
  519.  
  520.   To install the TCP/IP Protocol:
  521.  
  522.          1. DoubleClick on Protocol
  523.          2. Click on Microsoft
  524.          3. DoubleClick on TCP/IP
  525.  
  526.   Windows 95 by default installs several protocols automatically. Remove
  527.   them by clicking on them and clicking the Remove button. Typically
  528.   Win95 installs the Microsoft NetBeui protocol.
  529.  
  530.   To setup TCP/IP click on TCP/IP, click on Properties, click on the tab
  531.   IP address
  532.  
  533.          Enter your IP address in the 'Specify an IP address '
  534.                                box as 172.17.0.5
  535.          In the Subnet Mask box enter 255.255.255.0
  536.  
  537.   select the tab Gateway
  538.  
  539.          Enter your gateway (router) address in the box New gateway
  540.             as 172.17.0.254
  541.          Click the Add button
  542.  
  543.   The gateway address should now appear under the installed gateways
  544.   box. Now Click OK.
  545.  
  546.   You should get a message to reboot. Do so. You should now be able to
  547.   use the Browser to connect to your HTTP Server.
  548.  
  549.   4.4.3.  Windows NT
  550.  
  551.   This section details how to Install the TCP/IP client for WinNT 4.0.
  552.   Start Control Panel/ Network
  553.  
  554.            Select the Adapter tab.
  555.                Click Add to add a new adapter (if you don't have one)
  556.  
  557.   You should be prompted for your network adapter - select the appropri¡
  558.   ate one. To add the protocols.
  559.  
  560.            Select the Protocols tab
  561.                Click Add
  562.                Select the TCP/IP protocol
  563.                Click OK
  564.  
  565.   You will now be prompted to configure the TCP/IP protocol stack. You
  566.   can always reconfigure this by highlighting the TCP/IP protocol and
  567.   clicking the Properties button.
  568.  
  569.           Select the tab IP Address
  570.              Mark the checkbox 'Specify an IP address'
  571.              In the IP address box enter 172.17.0.5
  572.              In the Subnet Mask box enter 255.255.255.0
  573.              Enter your gateway (router) address in the box Default Gateway
  574.                  as 172.17.0.254
  575.  
  576.   Click OK. The computer will ask you to restart. You can now use any
  577.   Browser to connect to your HTTP Server.
  578.  
  579.   4.5.  Setup TCP/IP on Macintosh
  580.  
  581.   If you are using the Macintosh for accessing your network, then this
  582.   section details how to install MacTCP for the PowerMacs.
  583.  
  584.   Note: To enable you to refer to the Linux server as
  585.   http://linux.mydomain/ instead of http://172.16.0.1/ in the WWW
  586.   browser and all your intranet commands you need to edit the hosts
  587.   file. The format of the hosts file is different from the one used in
  588.   Unix. The Mac hosts file is based on RFC-1035. You can add more
  589.   entries for each of your other hosts (Netware, Unix, WinNT) as well.
  590.   The MacOS  keeps its HOSTS file in the Preferences folder under the
  591.   System folder. Edit this file and add a line for your Linux server as:
  592.  
  593.          linux.mydomain    A  172.16.0.1
  594.  
  595.          netware.mydomain  A  172.16.0.2
  596.          winNT.mydomain    A  172.16.0.3
  597.          ws_1              A  172.16.0.5
  598.  
  599.   4.5.1.  MacTCP
  600.  
  601.   This section explains how to install MacTCP. Firstly you must download
  602.   the MacTCP files from Apple or install it from the Internet Connection
  603.   CD.  To configure MacTCP, click the Apple Menu/ Control Panels/
  604.   TCP/IP. In the screen change the setting for 'Connect via:' to
  605.   'Ethernet'
  606.  
  607.   Change the 'Configure' setting to 'Manually'
  608.  
  609.          In the IP address box enter 172.17.0.5
  610.          In the Subnet Mask box enter 255.255.255.0
  611.          Enter your gateway (router) address in the box
  612.            Router address as 172.17.0.254
  613.  
  614.   Click OK. You should now be able to use the Browser to connect to your
  615.   HTTP Server.
  616.  
  617.   5.  Setting up the Intranet
  618.  
  619.   An Intranet cannot be complete without sharing the resources on the
  620.   different platforms. You will need support for other filesystems, so
  621.   that you can access the data available on them. This document provides
  622.   instructions to connect Linux to the following popular filesystems.
  623.  
  624.   ╖  ``NCP filesystem for Netware''
  625.  
  626.   ╖  ``SMB filesystem for Windows''
  627.  
  628.   ╖  ``NFS filesystem for Unix''
  629.  
  630.   These filesystems can be compiled into the Linux kernel or added as
  631.   modules, depending on the version of Linux. If you are not familiar
  632.   with compiling the kernel you can refer to the Kernel HOWTO
  633.   http://sunsite.unc.edu/mdw/HOWTO/Kernel-HOWTO.html and the Module
  634.   HOWTO http://sunsite.unc.edu/mdw/HOWTO/Module-HOWTO.html for compiling
  635.   the kernel with modules.
  636.  
  637.   5.1.  NCPFS
  638.  
  639.   To share the files on the Netware server you will need support for NCP
  640.   (ncpfs). NCPFS works with kernel version 1.2.x and 1.3.71 upwards. It
  641.   does not work with any earlier 1.3.x kernel. It cannot access the NDS
  642.   database in Netware 4.x, but can make use of the bindery. If you are
  643.   using Netware 4.x you can enable bindery support for specific
  644.   containers using the command Set Bindery Context at the console as:
  645.  
  646.          set Bindery Context = CORP.MYDOM;WEBUSER.MYDOM
  647.  
  648.   In the above example two containers have bindery support enabled.
  649.  
  650.   You will need to download the NCP filesystem utilities using the URL
  651.   ftp://sunsite.unc.edu/pub/Linux/system/filesystems/ncpfs/ncpfs.tgz
  652.   (currently ncpfs-2.0.10) from Sunsite.
  653.  
  654.   5.1.1.  Installation
  655.  
  656.   To install the ncpfs utilities, type
  657.  
  658.           zcat ncpfs.tgz | tar xvf -
  659.  
  660.   to expand the files into its own directory. In this case you will get
  661.   a directory ncpfs-2.0.10 Change your directory to this ncpfs directory
  662.   before proceeding with the installation. Read the README and edit the
  663.   Makefile if necessary.
  664.  
  665.   The installation of ncpfs depends on the kernel version you are using.
  666.   For kernel 1.2, you should simply type 'make'. Subsequently typing
  667.   'make install' will install the executables and man pages.
  668.  
  669.   If you use Kernel 1.3.71 or later, you might have to recompile your
  670.   kernel. With these kernels, the kernel part of ncpfs is already
  671.   included in the main source tree. To check if the kernel needs to be
  672.   recompiled type
  673.  
  674.           cat /proc/filesystems
  675.  
  676.   It should show you a line saying that the kernel knows ncpfs.
  677.  
  678.   If ncpfs is not there, you can either recompile the kernel or add
  679.   ncpfs as a module. For recompiling the kernel you should type 'make
  680.   config' and when it asks you for
  681.  
  682.   The IPX protocol (CONFIG_IPX) [N/y/?]
  683.  
  684.   simply answer 'y'. Probably you do not need the full internal net that
  685.   you are asked for next. Once the kernel is successfully installed,
  686.   reboot, check /proc/filesystems and if everything is OK proceed with
  687.   the installation of the ncpfs utilities. Change directory to the
  688.   location holding your downloaded ncpfs files, and type 'make'. After
  689.   the compilation is finished type 'make install' to install the various
  690.   utilities and man pages.
  691.  
  692.   5.1.2.  Mounting NCPFS
  693.  
  694.   To check the installation type
  695.  
  696.           ipx_configure --auto_interface=on --auto_primary=on
  697.  
  698.           slist
  699.  
  700.   You should be able to see a list of your Netware servers. Now we are
  701.   ready to share files from the Netware server.
  702.  
  703.   Suppose we need to access HTML files from directory \home\htmldocs on
  704.   volume VOL1: on the server MYDOM_NW, I recommend that you create a new
  705.   user (say) 'EXPORT' with password 'EXP123' on this server to whom you
  706.   grant appropriate access rights to this directory using SYSCON or
  707.   NWADMIN.
  708.  
  709.   On the Linux machine create a new directory /mnt/MYDOM_NW. Now type
  710.   the command
  711.  
  712.           ncpmount -S MYDOM_NW -U EXPORT -P EXP123 /mnt/MYDOM_NW
  713.  
  714.   to mount the netware file system. Typing the command
  715.  
  716.           ls /mnt/MYDOM_NW/vol1/home/htmldocs
  717.  
  718.   will show you a list of all the files in MYDOM_NW/VOL1:\HOME\HTMLDOCS
  719.   (using Netware file notation). If you have any problems please read
  720.   the IPX HOWTO at http://sunsite.unc.edu/mdw/HOWTO/IPX-HOWTO.html for
  721.   more insights into the IPX system.
  722.  
  723.   5.2.  SMBFS
  724.  
  725.   To share the files on the Windows server you will need support for SMB
  726.   (smbfs).
  727.  
  728.   You will need to download the SMB filesystem utilities from
  729.   ftp://sunsite.unc.edu/pub/Linux/system/filesystems/smbfs/smbfs.tgz
  730.   (currently smbfs-2.0.1) from Sunsite.
  731.  
  732.   5.2.1.  Installation
  733.  
  734.   To install the smbfs utilities, type
  735.  
  736.           zcat smbfs.tgz | tar xvf -
  737.  
  738.   to expand the files into its own directory. In this case you will get
  739.   a directory smbfs-2.0.1 Change your directory to this smbfs directory
  740.   before proceeding with the installation. Read the README and edit the
  741.   Makefile if necessary.
  742.  
  743.   The installation of smbfs depends on the kernel version you are using.
  744.   For kernel 1.2, you should simply type 'make'. Subsequently typing
  745.   'make install' will install the executables and man pages.
  746.  
  747.   If you use Kernel 2.0 or later, you might have to recompile your
  748.   kernel. With these kernels, the kernel part of smbfs is already
  749.   included in the main source tree. To check if the kernel needs to be
  750.   recompiled type
  751.  
  752.           cat /proc/filesystems
  753.  
  754.   It should show you a line saying that the kernel knows smbfs.
  755.  
  756.   If smbfs is not there, you can either recompile the kernel or add
  757.   smbfs as a module. For recompiling the kernel you should type 'make
  758.   config' and when it asks you for adding SMB filesystem support simply
  759.   answer yes. Once the kernel is successfully installed, reboot, check
  760.   /proc/filesystems and if everything is OK proceed with the
  761.   installation of the smbfs utilities. Change directory to the location
  762.   holding your downloaded smbfs files, and type 'make'. After the
  763.   compilation is finished type 'make install' to install the various
  764.   utilities and man pages.
  765.  
  766.   5.2.2.  Mounting SMBFS
  767.  
  768.   In our example let us assume that the WinNT server is called
  769.   'MYDOM_NT' and is sharing its directory C:\PUB\HTMLDOCS with a share
  770.   name of 'HTMLDOCS' without a password. On the Linux machine create a
  771.   new directory /mnt/MYDOM_NT. Now type the command
  772.  
  773.           smbmount //MYDOM_NT/HTMLDOCS /mnt/MYDOM_NT -n
  774.  
  775.   to mount the SMB (windows share) file system. If this does not work
  776.   try
  777.  
  778.           smbmount //MYDOM_NT/COMMON /mnt/MYDOM_NT -n -I 172.16.0.3
  779.  
  780.   Typing the command
  781.  
  782.           ls /mnt/MYDOM_NT
  783.  
  784.   will show you a list of all the files in
  785.   bsol;bsol;MYDOM_NT\PUB\HTMLDOCS (using Windows file notation).
  786.  
  787.   5.3.  NFS
  788.  
  789.   First you will need a kernel with the NFS file system either compiled
  790.   in or available as a module.
  791.  
  792.   Suppose you have a Unix host running NFS with the name MYDOM_UNIX and
  793.   an IP address of 172.16.0.4. You can check the directories that are
  794.   being exported (shared) by this host by typing the command
  795.  
  796.           showmount -e 172.16.0.4
  797.  
  798.   Once we know the exported directories you can mount them by entering a
  799.   appropriate mount command. I recommend that you create a subdirectory
  800.   under '/mnt' (say) 'MYDOM_UNIX' and use that as your mount point.
  801.  
  802.           mount -o rsize=1024,wsize=1024 172.16.0.4:/pub/htmldocs /mnt/MYDOM_UNIX
  803.  
  804.   The rsize and wsize may have to be changed depending on your environ¡
  805.   ment.
  806.  
  807.   If you have any problems please read the NFS HOWTO at
  808.   http://sunsite.unc.edu/mdw/HOWTO/NFS-HOWTO.html for more insights into
  809.   the NFS system.
  810.  
  811.   6.  Accessing the Web
  812.  
  813.   Now that we have setup the HTTP server, the clients and interconnected
  814.   the Linux server with the other servers, we need to make some small
  815.   adjustments on the Linux server to be able to access these mounted
  816.   filesystems from the Web Browser.
  817.  
  818.   6.1.  Accessing the mounted filesystems
  819.  
  820.   To access the mounted directories in your HTML pages you have two
  821.   methods:
  822.  
  823.   ╖  Create a link in DocumentRoot (/usr/local/etc/httpd/htdocs) to
  824.      refer to the mounted directory as
  825.  
  826.      ln -s /mnt/MYDOM_NW/vol1/home/htmldocs netware
  827.                        or
  828.  
  829.      ln -s /mnt/MYDOM_NT    winNT
  830.                        or
  831.  
  832.      ln -s /mnt/MYDOM_UNIX    unix
  833.  
  834.   ╖  to edit the file srm.conf in your /usr/local/etc/httpd/conf
  835.      directory and add a new alias.
  836.  
  837.          # Alias fakename realname
  838.          Alias /icons/     /usr/local/etc/httpd/icons/
  839.  
  840.          # alias for netware server
  841.          Alias /netware/   /mnt/MYDOM_NW/vol1/home/htmldocs/
  842.          Alias /winNT/     /mnt/MYDOM_NT/
  843.          Alias /unix/      /mnt/MYDOM_UNIX
  844.  
  845.   And restart your HTTPd. You can access the documents on the netware
  846.   server by referring to them as http://linux.mydomain/netware/index.htm
  847.   for the netware files and similar notations for the others.
  848.  
  849.   6.2.  Connecting to the Internet
  850.  
  851.   You can finally connect your Intranet to the Internet to access E-Mail
  852.   and all the wonderful information out there. I propose to write a
  853.   brief note on how to do this in a future revision. Detailed
  854.   explanations are available in the ISP Hookup HOWTO from
  855.   http://sunsite.unc.edu/mdw/HOWTO/ISP-Hookup-HOWTO.html and Diald mini
  856.   HOWTO at http://sunsite.unc.edu/mdw/HOWTO/mini/Diald for setting up
  857.   these connections.
  858.  
  859.   6.3.  Other uses
  860.  
  861.   The HTTP server can be used in the office to provide transparent
  862.   access to information residing on different servers, at several
  863.   locations and directories. The data can be simple documents in Word,
  864.   Lotus spreadsheets, or complex databases.
  865.  
  866.   The application of this technology is being typically used as
  867.   follows:-
  868.  
  869.   ╖  Publishing corporate documents
  870.  
  871.      These documents can include newsletters, annual reports, maps,
  872.      company facilities, price lists, product information literature,
  873.      and any document which is of value within the corporate entity.
  874.  
  875.   ╖  Access into searchable directories
  876.  
  877.      Rapid access to corporate phone books and the like. This data can
  878.      be mirrored at a Web site or, via CGI scripts, the Web server can
  879.      serve  as a gateway to back-end pre-existing or new applications.
  880.      This means that, using the same standard access mechanisms,
  881.      information can be made more widely available and in a simpler
  882.      manner.  This means that it can be used to create an interface with
  883.      RDBMS  like ORACLE and SYBASE for generating real-time information.
  884.      Here is a list of links to such sites on the Web.
  885.  
  886.      - Web Access -
  887.      http://cscsun1.larc.nasa.gov/~beowulf/db/web_access.html - CGI
  888.      gateways - HTTP://www.w3.org/hypertext/WWW/RDBGate/Overview.html
  889.  
  890.   ╖  Corporate/Department/Individual pages
  891.  
  892.      As cultures change within organistions to the point where even each
  893.      department moves towards their own individual mission statements,
  894.      the Intranet technology provides the ideal medium to communicate
  895.      current information to the Department or Individual. Powerful
  896.      search engines provide the means for people to find the group or
  897.      individual who has the answers to the continuous questions which
  898.      arise in the normal day-to-day course of doing business.
  899.  
  900.   ╖  Simple Groupware applications
  901.  
  902.      With HTML forms support, sites can provide sign-up sheets, surveys
  903.      and simple scheduling.
  904.  
  905.   ╖  Software distribution
  906.  
  907.      Administrators can use the Intranet to deliver software and up-
  908.      dates on-demand to users across the corporate network . This can be
  909.      done with 'Java' which allows the creation and transparent
  910.      distribution of objects on-demand rather than just data or
  911.      applications. This is indeed possible more easily with the newer
  912.      versions of Linux which has builtin support for Java.
  913.  
  914.   ╖  Mail
  915.  
  916.      With the move to the use of Intranet mail products with standard
  917.      and simple methods for attachment of documents, sound, vision and
  918.      other multimedia between individuals, mail is being pushed further
  919.      forward as a simple, de facto communications method. Mail is
  920.      essentially individual to individual, or individual to small group,
  921.      communication. Several utilities are available on the Linux
  922.      platform to setup an E-mail system like sendmail, pop3d, imapd.
  923.  
  924.   ╖  User Interface
  925.  
  926.      The Intranet technology is evolving so rapidly that the tools
  927.      available, in particular HTML, can be used to dramatically change
  928.      the way we interface with systems. With HTML you can build an
  929.      Interface which is only limited by the creators imagination. The
  930.      beauty about using Intranet technologies for this is that it is so
  931.      simple. Clicking a hyperlink from HTML can take you to another
  932.      page, it could ring an alarm, run a yearend procedure or anything
  933.      else that a computer program can do.
  934.  
  935.   7.  More things to do
  936.  
  937.   Here is a list of other interesting things to do with your Linux
  938.   Intranet server. All the software mentioned below is freeware or
  939.   shareware.
  940.  
  941.   ╖  Browse the Linux server using Network Neighbourhood in Win95/ NT;
  942.      Setup a WINS like NBT server. Check out the SAMBA Web page at
  943.      http://lake.canberra.edu.au/pub/samba/samba.html
  944.   ╖  Implement a search engine on your Intranet. Connect to ht://Dig at
  945.      http://htdig.sdsu.edu/
  946.  
  947.   ╖  Use CUSeeMe by setting up a local reflector. Refer to their page at
  948.      Cornell http://cu-seeme.cornell.edu/
  949.  
  950.   ╖  Setup Web Conferencing. Use COW from http://thecity.sfsu.edu/COW/
  951.  
  952.   ╖  Deploy a SQL database. Refer to the mSQL Home page at
  953.      http://Hughes.com.au/
  954.  
  955.   ╖  Setup FTP,Gopher,Finger,Bootp servers on the Netware server. Get
  956.      them at http://mft.ucs.ed.ac.uk/
  957.  
  958.   ╖  Emulate a Netware server. Check out the NCP Utilities at
  959.      ftp://sunsite.unc.edu/pub/Linux/system/filesystems/ncpfs/
  960.  
  961.      If you find other interesting things to do with your Linux Intranet
  962.      server, please feel free to mail me.
  963.  
  964.   8.  Credits and Legalities
  965.  
  966.   8.1.  Thanks
  967.  
  968.   Thanks to the people at NCSA for providing such excellent
  969.   documentation, David Anderson and all others for trying out this HOWTO
  970.   and sending in their comments. The details on Netware/IP are courtesy
  971.   Romel Flores (rom@mnl.sequel.net).
  972.  
  973.   8.2.  Copyright information
  974.  
  975.   This document is copyrighted ⌐ 1996,1997 Pramod Karnad and distributed
  976.   under the following terms:
  977.  
  978.   ╖  Linux HOWTO documents may be reproduced and distributed in whole or
  979.      in part, in any medium physical or electronic, as long as this
  980.      copyright notice is retained on all copies. Commercial
  981.      redistribution is allowed and encouraged; however, the author would
  982.      like to be notified of any such distributions.
  983.  
  984.   ╖  All translations, derivative works, or aggregate works
  985.      incorporating any Linux HOWTO documents must be covered under this
  986.      copyright notice.  That is, you may not produce a derivative work
  987.      from a HOWTO and impose additional restrictions on its
  988.      distribution. Exceptions to these rules may be granted under
  989.      certain conditions; please contact the Linux HOWTO coordinator at
  990.      the address given below.
  991.  
  992.   ╖  If you have questions, please contact Greg Hankins, the Linux HOWTO
  993.      coordinator, at gregh@sunsite.unc.edu  Finger for phone number and
  994.      snail mail address.
  995.  
  996.